home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glgetmap.z / glgetmap
Encoding:
Text File  |  2001-04-17  |  8.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllGGGGeeeettttMMMMaaaappppddddvvvv,,,, ggggllllGGGGeeeettttMMMMaaaappppffffvvvv,,,, ggggllllGGGGeeeettttMMMMaaaappppiiiivvvv - return evaluator parameters
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllGGGGeeeettttMMMMaaaappppddddvvvv( GLenum _t_a_r_g_e_t,
  14.                       GLenum _q_u_e_r_y,
  15.                       GLdouble *_v )
  16.      void ggggllllGGGGeeeettttMMMMaaaappppffffvvvv( GLenum _t_a_r_g_e_t,
  17.                       GLenum _q_u_e_r_y,
  18.                       GLfloat *_v )
  19.      void ggggllllGGGGeeeettttMMMMaaaappppiiiivvvv( GLenum _t_a_r_g_e_t,
  20.                       GLenum _q_u_e_r_y,
  21.                       GLint *_v )
  22.  
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _t_a_r_g_e_t  Specifies the symbolic name of a map.  Accepted values are
  26.              GGGGLLLL____MMMMAAAAPPPP1111____CCCCOOOOLLLLOOOORRRR____4444, GGGGLLLL____MMMMAAAAPPPP1111____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____MMMMAAAAPPPP1111____NNNNOOOORRRRMMMMAAAALLLL,
  27.              GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____1111, GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____2222,
  28.              GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____3333, GGGGLLLL____MMMMAAAAPPPP1111____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____4444,
  29.              GGGGLLLL____MMMMAAAAPPPP1111____VVVVEEEERRRRTTTTEEEEXXXX____3333, GGGGLLLL____MMMMAAAAPPPP1111____VVVVEEEERRRRTTTTEEEEXXXX____4444, GGGGLLLL____MMMMAAAAPPPP2222____CCCCOOOOLLLLOOOORRRR____4444,
  30.              GGGGLLLL____MMMMAAAAPPPP2222____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____MMMMAAAAPPPP2222____NNNNOOOORRRRMMMMAAAALLLL, GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____1111,
  31.              GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____2222, GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____3333,
  32.              GGGGLLLL____MMMMAAAAPPPP2222____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____4444, GGGGLLLL____MMMMAAAAPPPP2222____VVVVEEEERRRRTTTTEEEEXXXX____3333, and GGGGLLLL____MMMMAAAAPPPP2222____VVVVEEEERRRRTTTTEEEEXXXX____4444.
  33.  
  34.      _q_u_e_r_y   Specifies which parameter to return.  Symbolic names GGGGLLLL____CCCCOOOOEEEEFFFFFFFF,
  35.              GGGGLLLL____OOOORRRRDDDDEEEERRRR, and GGGGLLLL____DDDDOOOOMMMMAAAAIIIINNNN are accepted.
  36.  
  37.      _v       Returns the requested data.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ggggllllMMMMaaaapppp1111 and ggggllllMMMMaaaapppp2222 define evaluators.  ggggllllGGGGeeeettttMMMMaaaapppp returns evaluator
  41.      parameters.  _t_a_r_g_e_t chooses a map, _q_u_e_r_y selects a specific parameter,
  42.      and _v points to storage where the values will be returned.
  43.  
  44.      The acceptable values for the _t_a_r_g_e_t parameter are described in the
  45.      ggggllllMMMMaaaapppp1111 and ggggllllMMMMaaaapppp2222 reference pages.
  46.  
  47.      _q_u_e_r_y can assume the following values:
  48.  
  49.      GGGGLLLL____CCCCOOOOEEEEFFFFFFFF       _v returns the control points for the evaluator function.
  50.                     One-dimensional evaluators return order control points,
  51.                     and two-dimensional evaluators return uorder x vorder
  52.                     control points.  Each control point consists of one, two,
  53.                     three, or four integer, single-precision floating-point,
  54.                     or double-precision floating-point values, depending on
  55.                     the type of the evaluator.  The GL returns two-dimensional
  56.                     control points in row-major order, incrementing the uorder
  57.                     index quickly and the vorder index after each row.
  58.                     Integer values, when requested, are computed by rounding
  59.                     the internal floating-point values to the nearest integer
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))                   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                   ggggllllGGGGeeeettttMMMMaaaapppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.                     values.
  75.  
  76.      GGGGLLLL____OOOORRRRDDDDEEEERRRR       _v returns the order of the evaluator function.  One-
  77.                     dimensional evaluators return a single value, order. The
  78.                     initial value is 1.  Two-dimensional evaluators return two
  79.                     values, uorder and vorder. The initial value is 1,1.
  80.  
  81.      GGGGLLLL____DDDDOOOOMMMMAAAAIIIINNNN      _v returns the linear u and v mapping parameters.  One-
  82.                     dimensional evaluators return two values, u1 and u2, as
  83.                     specified by ggggllllMMMMaaaapppp1111.  Two-dimensional evaluators return
  84.                     four values (u1, u2, v1, and v2) as specified by ggggllllMMMMaaaapppp2222.
  85.                     Integer values, when requested, are computed by rounding
  86.                     the internal floating-point values to the nearest integer
  87.                     values.
  88.  
  89. NNNNOOOOTTTTEEEESSSS
  90.      If an error is generated, no change is made to the contents of _v.
  91.  
  92. EEEERRRRRRRROOOORRRRSSSS
  93.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if either _t_a_r_g_e_t or _q_u_e_r_y is not an accepted
  94.      value.
  95.  
  96.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttMMMMaaaapppp is executed between the
  97.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  98.  
  99.  
  100. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  101.      ggggllllEEEEvvvvaaaallllCCCCoooooooorrrrdddd, ggggllllMMMMaaaapppp1111, ggggllllMMMMaaaapppp2222
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.